pp108 : Creating a Drill-down for Process Monitoring Object Instances

Creating a Drill-down for Process Monitoring Object Instances

This topic describes the procedure to drill down to Process Monitoring Object Instances from a view (built on Business Measure) in the dashboard.

Before you begin this task:

  • Create a Business Measure from which you want to create a drill-down.
  • You must have the Process Administrator Role of Cordys Business Process Engine application to view the Activity View.

The views help in root-cause analysis, whereby you can point out the bottlenecks, if any, in the process instance. Analysis of the instance-level details provides information such as Status, Duration, Scheduled to, and so on.
Note: You cannot drill down to MonitoringObjectInstances for a Business Measure built on EDO or Web services.

  1. From the project content tree, drag a Business Measure, which is available as a composite control, on Dashboard (XForms) Designer.
  2. Reuse the ProcessMonitoringObjectInstances, ProcessInstanceGraphicalView, and ProcessInstanceActivities composite controls. In the Untitled Composite Control - Composite Control that appears, ensure that you select the ProcessMonitoringObjectInstances composite control from the Cordys Business Activity Monitoring folder, and select the ProcessInstanceGraphicalView and ProcessInstanceActivities composite controls from the Cordys Business Process Engine folder. The respective composite controls are added to the project content tree.
  3. Drag the ProcessMonitoringObjectInstances composite control to the XForms Designer.
  4. Right-click the Business Measure for which you want to attach the ProcessMonitoringObjectInstances and select Configure drill down. The Message Map dialog box appears.
  5. Map the output parameter of the source view (Business Measure selected) to the input parameter of the target view (ProcessMonitoringObjectInstances). In case of ProcessMonitoringObjectInstances, map the measureid of the Business Measure to the measureid of the ProcessMonitoringObjectinstances. Click OK.
    Note: Refer to Using Message Map for more information on performing parameter mapping. The parameters of the source view and the target view are mapped.
  6. From the project content tree, drag the ProcessInstanceGraphicalView and ProcessInstanceActivities composite controls that you have added as composite controls to the XForm Designer.
  7. Right-click the Monitoring View on the XForm Designer, and select Configure Drill Down. The Message Map dialog box appears.
  8. Map the INSTANCE_ID of the source view (ProcessMonitoringObjectInstances) to the InstanceID of the target view (ProcessInstanceGraphicalView and ProcessInstanceActivities).
    Note: For further details on creating a User Interface (XForm), refer to Creating XForms.
  9. Click (Preview). The Preview window appears, displaying a preview of the selected XForm.
  10. In the XForm preview, click a data point in the view generated for source view (Business Measure). For example, click the bar graph if the view type for the content is 'Bar chart'. This will open up the target view (ProcessMonitoringObjectInstances).
  11. In the XForm preview, click any instance on the ProcessMonitoringObjectInstances. The ProcessInstanceGraphicalView and the ProcessInstanceActivities of the process instance appear up as the target view at a specified location in the layout.
  12. Save the XForm and assign it to a user or role. For more information on assigning the XForm to a user, refer to Assigning Tasks to Users. You can access the dashboard created through XForms designer based on your access permissions.
    Drill-down for the Process Monitoring Object is created.

Related information

Process Monitoring Object Instances